Get Event Lineage

Route

/v2/event-lineage

Description

Trace data movement lineage between events to understand how data flows through your environment. Returns a list of event IDs that connect the start and end events.

Method

POST (Recommended) | GET | GET with path parameters

Inputs

Parameter	Type	Required	Description
start_event_id	string	Yes	The first event in the lineage chain
end_event_id	string	Yes	The last event in the lineage chain

Request Methods

POST (Recommended)

{
  "start_event_id": "event-123",
  "end_event_id": "event-789"
}

GET with Query Parameters

GET /v2/event-lineage?start_event_id=event-123&end_event_id=event-789

GET with Path Parameters

GET /v2/event-lineage/event-123/to/event-789

Output

Field	Type	Description
resources	array[string]	Array of event IDs in lineage order
errors	array[Error]	Any errors encountered

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "resources": [
    "event-123",
    "event-456", 
    "event-789"
  ],
  "errors": []
}